不正防止サービス(ReD Shield) API一覧
HTTP仕様(.idPass)
Request header |
Content-Type: application/x-www-form-urlencoded;charset=UTF-8 |
|
---|---|---|
Method |
POST |
|
Response header |
Content-Type: text/plain;charset=UTF-8 |
|
Status Code |
200:常に200を返却 |
ExecFraudScreening 不正審査
カード決済情報(取引情報、顧客情報)を基に不正審査を行い結果を返却します。
リクエスト
ShopID | 必須 半角英数13桁
ショップID |
|
---|---|---|
ShopPass | 必須 半角英数64桁
ショップパスワード |
|
RED_CURR_CD | 半角英字3桁
通貨コード ISO4217の通貨コードを指定します。 |
|
RED_ACCT_NUM | 半角数字16桁
予備項目 |
|
RED_CARD_EXP_DT | 半角数字4桁
予備項目 |
|
RED_CUST_ID | 全半角60バイト
ユーザID加盟店様サイトのユーザIDを設定します。 |
|
RED_CUST_FNAME | 全半角50バイト
カード名義カード名義を設定します。 |
|
RED_CUST_LNAME | 全半角30バイト
請求先顧客苗字請求先顧客の苗字を設定します。 |
|
RED_CUST_MNAME | 全半角30バイト
請求先顧客ミドルネーム請求先顧客のミドルネームを設定します。 |
|
RED_CUST_ADDR1 | 全半角256バイト
請求先顧客住所1請求先顧客の住所1を設定します。 |
|
RED_CUST_ADDR2 | 全半角256バイト
請求先顧客住所2請求先顧客の住所2を設定します。 |
|
RED_CUST_ADDR3 | 全半角256バイト
請求先顧客住所3請求先顧客の住所3(アパート・マンション及び部屋番号)を設定します。 |
|
RED_CUST_CITY | 全半角20バイト
請求先顧客都道府県請求先顧客の都道府県を設定します。 |
|
RED_CUST_POSTAL_CD | 半角英数9桁
請求先顧客郵便番号 請求先顧客の郵便番号を設定します。 |
|
RED_CUST_CNTRY_CD | 半角英字2桁
請求先国コード 請求先顧客のISO3166-1 alpha-2の国コードを設定します。 |
|
RED_CUST_STPR_CD | 全半角10バイト
請求先顧客州請求先顧客の州を設定します。 |
|
RED_CUST_HOME_PHONE | 半角数字19桁
請求先顧客電話番号 請求先顧客の電話番号を設定します。 |
|
RED_CUST_MOBILE_PHONE | 半角数字19桁
請求先顧客携帯電話番号 請求先顧客の携帯電話番号を設定します。 |
|
RED_CUST_WORK_PHONE | 半角数字19桁
請求先顧客電話番号(予備) 請求先顧客の電話番号(予備)を設定します。 |
|
RED_CUST_EMAIL | 半角英数記号45桁
請求先顧客メールアドレス請求先顧客のメールアドレスを設定します。 |
|
RED_CUST_GENDER | 半角英字1桁
請求先顧客性別 請求先顧客の性別を設定します。 |
|
RED_CUST_DOC_TYPE | 半角英字12桁
請求先顧客政府発行IDタイプ マイナンバーカードの場合はIDCARD、パスポートの場合はPASSPORT、納税証明書の場合はTAXSTATEMENTを設定します。 |
|
RED_CUST_DOC_ID | 半角英数記号20桁
請求先顧客政府発行ID 設定した請求先顧客政府発行IDタイプに対するIDを設定します。 |
|
RED_CUST_BIRTH_DT | 半角数字8桁
請求先顧客生年月日請求先顧客の生年月日をYYYYMMDD書式で設定します。 |
|
RED_CUST_IP_ADDR | 半角英数39桁
エンドユーザIPアドレス エンドユーザのIPアドレスを設定します。 |
|
RED_EBT_PREVCUST | 半角英字1桁
新規ユーザフラグ顧客が新規ユーザの場合はY、既存ユーザの場合はNを設定します。 |
|
RED_EBT_TOF | 半角数字7桁
ユーザID登録後経過日数ユーザIDを登録してからの日数を入力します。 |
|
RED_SHIP_FNAME | 全半角30バイト
発送先名前発送先の名前を設定します。 |
|
RED_SHIP_LNAME | 全半角30バイト
発送先苗字発送先の苗字を設定します。 |
|
RED_SHIP_MNAME | 全半角30バイト
発送先ミドルネーム発送先のミドルネームを設定します。 |
|
RED_SHIP_ADDR1 | 全半角256バイト
発送先住所1発送先の住所1を設定します。 |
|
RED_SHIP_ADDR2 | 全半角256バイト
発送先住所2発送先の住所2を設定します。 |
|
RED_SHIP_ADDR3 | 全半角256バイト
発送先住所3発送先の住所3(アパート・マンション及び部屋番号)を設定します。 |
|
RED_SHIP_CITY | 全半角20バイト
発送先都道府県発送先の都道府県を設定します。 |
|
RED_SHIP_POSTAL_CD | 半角英数9桁
発送先郵便番号 発送先の郵便番号を設定します。 |
|
RED_SHIP_CNTRY_CD | 半角英字2桁
発送先国コード 発送先のISO3166-1 alpha-2の国コードを設定します。 |
|
RED_SHIP_STPR_CD | 全半角10バイト
発送先州発送先の州を設定します。 |
|
RED_SHIP_HOME_PHONE | 半角数字19桁
発送先電話番号 発送先の電話番号を設定します。 |
|
RED_SHIP_EMAIL | 半角英数記号60桁
発送先メールアドレス発送先のメールアドレスを設定します。 |
|
RED_SHIP_CO_NAME | 全半角60バイト
発送先会社名発送先の会社名を設定します。 |
|
RED_SHIP_COST | 半角数字12桁
送料送料を設定します。 |
|
RED_SHIP_TRACKING_NO | 全半角19バイト
トラッキング番号トラッキング番号を設定します。 |
|
RED_SHIP_COMTS | 全半角160バイト
発送時コメント発送時コメントを設定します。 |
|
RED_SHIP_MTHD | 半角英字記号30桁
発送方法 発送方法を以下から設定します。 |
|
RED_EBT_DEVICEPRINT | 全半角65535バイト
デバイス情報iovationより取得した文字列を設定します。(※1) |
|
RED_EBT_USER_DATA8 | 全半角256バイト
予備項目8 |
|
RED_EBT_USER_DATA9 | 全半角256バイト
予備項目9 |
|
RED_EBT_USER_DATA11 | 半角数字9桁
再購入日数前回の購入からの経過日数を設定します。 |
|
RED_EBT_USER_DATA12 | 半角数字9桁
過去購買回数これまでに購入した回数を設定します。 |
|
RED_EBT_USER_DATA15 | 半角英字1桁
郵便局・営業所留フラグ郵便局留め、宅配営業センター留め、コンビニエンスストア留めの場合はY、それ以外はNを設定します。 |
|
RED_EBT_USER_DATA16 | 全半角30バイト
郵便局・営業所名郵便局留め、宅配営業センター留め、コンビニエンスストア留めの場合は、名称を設定します。 |
|
RED_EBT_USER_DATA17 | 半角数字9桁
ユーザポイント残高ユーザのポイント残高を設定します。 |
|
RED_EBT_USER_DATA18 | 半角数字9桁
カード登録変更回数ユーザのカード情報の変更回数を設定します。 |
|
RED_EBT_USER_DATA19 | 全半角30バイト
予備項目19 |
|
RED_EBT_USER_DATA20 | 半角数字9桁
カード登録後経過日数カードを登録してからの日数を入力します。 |
|
RED_EBT_USER_DATA21 | 全半角30バイト
予備項目21 |
|
RED_EBT_USER_DATA22 | 全半角30バイト
予備項目22 |
|
RED_EBT_USER_DATA23 | 全半角30バイト
予備項目23 |
|
RED_EBT_USER_DATA24 | 全半角30バイト
予備項目24 |
|
RED_EBT_USER_DATA25 | 全半角30バイト
予備項目25 |
|
RED_EBT_USER_DATA26 | 全半角255バイト
予備項目26 |
|
RED_EBT_USER_DATA27 | 全半角255バイト
予備項目27 |
|
RED_EBT_USER_DATA28 | 全半角255バイト
予備項目28 |
|
RED_EBT_USER_DATA29 | 全半角255バイト
予備項目29 |
|
RED_EBT_USER_DATA30 | 全半角255バイト
予備項目30 |
|
RED_EBT_USER_DATA31 | 全半角255バイト
予備項目31 |
|
RED_EBT_USER_DATA32 | 全半角255バイト
予備項目32 |
|
RED_EBT_USER_DATA33 | 全半角255バイト
予備項目33 |
|
RED_EBT_USER_DATA34 | 全半角255バイト
予備項目34 |
|
RED_EBT_USER_DATA35 | 全半角255バイト
予備項目35 |
|
RED_EBT_USER_DATA36 | 全半角255バイト
予備項目36 |
|
RED_EBT_USER_DATA37 | 全半角255バイト
予備項目37 |
|
RED_EBT_USER_DATA38 | 全半角255バイト
予備項目38 |
|
RED_EBT_USER_DATA39 | 全半角255バイト
予備項目39 |
|
RED_EBT_USER_DATA40 | 全半角255バイト
予備項目40 |
|
RED_EBT_USER_DATA41 | 全半角255バイト
予備項目41 |
|
RED_EBT_USER_DATA42 | 全半角255バイト
予備項目42 |
|
RED_EBT_USER_DATA43 | 全半角255バイト
予備項目43 |
|
RED_EBT_USER_DATA44 | 全半角255バイト
予備項目44 |
|
RED_EBT_USER_DATA45 | 全半角255バイト
予備項目45 |
|
RED_EBT_USER_DATA46 | 全半角255バイト
予備項目46 |
|
RED_EBT_USER_DATA47 | 全半角255バイト
予備項目47 |
|
RED_EBT_USER_DATA48 | 全半角255バイト
予備項目48 |
|
RED_EBT_USER_DATA49 | 全半角255バイト
予備項目49 |
|
RED_EBT_USER_DATA50 | 全半角255バイト
予備項目50 |
|
RED_OI_REPEAT | 半角数字2桁
商品情報繰り返し回数 商品情報項目の繰り返し回数を設定します。(1~99) |
|
RED_ITEM_MRCT_IDn | 全半角30バイト
商品ID商品IDを設定します。 |
|
RED_ITEM_TRACKING_NOn | 全半角19バイト
商品トラッキング番号商品トラッキング番号を設定します。 |
|
RED_ITEM_QTYn | 半角数字5桁
商品個数商品の個数を設定します。 |
|
RED_ITEM_SKUn | 全半角12バイト
商品SKU商品SKUを設定します。 |
|
RED_ITEM_PROD_CDn | 半角英数記号18桁
商品識別コード商品の識別コードを設定します。 |
|
RED_ITEM_MAN_PART_NOn | 半角英数記号30桁
商品IAN/JANコード商品のIAN/JANコードを設定します。 |
|
RED_ITEM_DESCn | 全半角50バイト
商品カテゴリー商品のカテゴリーを設定します。 |
|
RED_EBT_ITEM_CSTn | 半角数字12桁
商品単価商品の単価を設定します。 |
|
RED_ITEM_GIFT_MSGn | 全半角160バイト
商品名商品の名称を設定します。 |
|
RED_ITEM_NAMEn | 全半角64バイト
商品名(予備)商品名(予備)を設定します。 |
|
RED_ITEM_SHIP_COMTSn | 全半角160バイト
商品説明商品説明を設定します。 |
|
RED_ITEM_SHIP_MTHDn | 半角英字記号30桁
商品発送方法 商品発送方法を以下から設定します。 |
|
RED_ITEM_TYPEn | 半角英字1桁
商品タイプ 商品タイプを以下から設定します。 |
|
RED_ITEM_CATEGORYn | 半角英字1桁
商品プロモーションフラグ 商品プロモーションフラグを以下から設定します。 |
|
RED_RECIP_FNAMEn | 全半角30バイト
商品発送先名前商品発送先名前を設定します。 |
|
RED_RECIP_LNAMEn | 全半角30バイト
商品発送先苗字商品発送先苗字を設定します。 |
|
RED_RECIP_MNAMEn | 全半角30バイト
商品発送先ミドルネーム商品発送先ミドルネームを設定します。 |
|
RED_RECIP_ADDR1_n | 全半角30バイト
商品発送先住所1商品発送先住所1を設定します。 |
|
RED_RECIP_ADDR2_n | 全半角30バイト
商品発送先住所2商品発送先住所2を設定します。 |
|
RED_RECIP_ADDR3_n | 全半角30バイト
商品発送先住所3商品発送先住所3を設定します。 |
|
RED_RECIP_CITYn | 全半角30バイト
商品発送先都道府県商品発送先都道府県を設定します。 |
|
RED_RECIP_POSTAL_CDn | 半角英数9桁
商品発送先郵便番号 商品発送先郵便番号を設定します。 |
|
RED_RECIP_CNTRY_CDn | 半角英字2桁
商品発送先国コード商品発送先のISO3166-1 alpha-2の国コードを設定します。 |
|
RED_RECIP_STPR_CDn | 全半角10バイト
商品発送先州商品発送先州を設定します。 |
|
RED_RECIP_PHONEn | 半角数字19桁
商品発送先電話番号商品発送先電話番号を設定します。 |
|
RED_RECIP_EMAILn | 半角英数記号60桁
商品発送先メールアドレス商品発送先メールアドレスを設定します。 |
|
RED_RECIP_SALUTATIONn | 半角英数記号5桁
商品発送先敬称商品発送先敬称を設定します。 |
|
RED_GIFT_CARD_MSG | 全半角160バイト
ギフトカードメッセージギフトカードメッセージを設定します。 |
|
RED_GIFT_CARD_TYPE | 半角英字記号17桁
ギフトカードタイプ ギフトカードタイプを以下から設定します。 |
|
ExecMode | 全半角32バイト
実行オプション 以下の値を設定すると実行動作が変わります。 |
取引IDを使用する場合
各パラメータは取引ID利用のみ設定してください。
AccessID | 必須 半角英数32桁 固定
取引ID
本値を設定した場合、本値により指定された取引の決済金額、カード番号、有効期限、与信結果を使って不正審査を実行します。
|
|
---|---|---|
AccessPass | 必須 半角英数32桁 固定
取引パスワード
本値を設定した場合、本値により指定された取引の決済金額、カード番号、有効期限、与信結果を使って不正審査を実行します。
|
オーダーIDを使用する場合
下記パラメータはオーダーID利用のみ設定してください。
OrderID | 必須 半角英数記号27桁
オーダーID
本値を設定した場合、本値により指定された取引の決済金額、カード番号、有効期限、与信結果を使って不正審査を実行します。
|
---|
トークンを使用する場合
下記パラメータはトークン利用のみ設定してください。
Token | 必須
カード情報トークン カード番号トークン化サービスで取得したトークンを設定してください。 |
|
---|---|---|
RED_AMT | 必須 半角数字10桁
決済金額決済金額(利用金額+税送料)を設定します。 |
|
RED_EBT_USER_DATA13 | 必須 半角英数30桁
与信結果 与信結果のエラー詳細コードを設定します。 |
会員IDを使用する場合
下記パラメータは会員ID利用のみ設定してください。
MemberID | 必須 半角英数記号10桁
会員ID カード登録済の会員IDを設定してください。 |
|
---|---|---|
RED_AMT | 必須 半角数字10桁
決済金額決済金額(利用金額+税送料)を設定します。 |
|
RED_EBT_USER_DATA13 | 必須 半角英数30桁
与信結果 与信結果のエラー詳細コードを設定します。 |
|
SiteID | 必須 半角英数13桁
サイトID弊社が発行する値を設定します。 |
|
SitePass | 必須 半角英数10桁
サイトパスワード弊社が発行する値を設定します。 |
|
SeqMode | 半角数字1桁
カード登録連番モード 以下のいずれかを設定します。 |
|
CardSeq | 必須 半角数字4桁
カード登録連番不正審査に使用するカード登録連番を設定します。 |
※1:RED_EBT_DEVICEPRINTについて
本値は加盟店様サイトにアクセスしたブラウザの情報です。
本値を取得するには、スクデット社が提供している「4-1_デバイス情報取得ガイド」を参考に設定をお願いいたします。
※2:海外発行カードについて
弊社が保有する国内発行事業者のBIN(カード番号のプレフィックス)に該当しないカード番号を海外発行カードと判断します。
/payment/ExecFraudScreening.idPass
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&RED_CURR_CD=JPY&RED_CUST_FNAME=TAROU YAMADA&RED_CUST_ADDR1=渋谷区&RED_CUST_ADDR2=道玄坂1-14-6&RED_CUST_ADDR3=ヒューマックス渋谷ビル&RED_CUST_CITY=東京都&RED_CUST_POSTAL_CD=1500043&RED_CUST_CNTRY_CD=JP&RED_CUST_HOME_PHONE=0300000001&RED_CUST_EMAIL=test@example.com&RED_EBT_PREVCUST=Y&RED_SHIP_FNAME=太郎&RED_SHIP_LNAME=山田&RED_SHIP_ADDR1=渋谷区&RED_SHIP_ADDR2=道玄坂1-14-6&RED_SHIP_ADDR3=ヒューマックス渋谷ビル&RED_SHIP_CITY=東京都&RED_SHIP_POSTAL_CD=1234567&RED_EBT_USER_DATA11=1&RED_EBT_USER_DATA12=2&RED_EBT_USER_DATA15=Y&RED_EBT_USER_DATA17=100&RED_EBT_USER_DATA18=1&RED_EBT_USER_DATA20=10&RED_OI_REPEAT=1&RED_ITEM_QTY1=1&RED_ITEM_PROD_CD1=123456789&RED_ITEM_MAN_PART_NO1=123456789&RED_ITEM_DESC1=食品&RED_EBT_ITEM_CST1=1000&RED_ITEM_GIFT_MSG1=コーヒー豆
ShopID=tshop11223344&ShopPass=PASSWORD&OrderID=ORDER0000001&RED_CURR_CD=JPY&RED_CUST_FNAME=TAROU YAMADA&RED_CUST_ADDR1=渋谷区&RED_CUST_ADDR2=道玄坂1-14-6&RED_CUST_ADDR3=ヒューマックス渋谷ビル&RED_CUST_CITY=東京都&RED_CUST_POSTAL_CD=1500043&RED_CUST_CNTRY_CD=JP&RED_CUST_HOME_PHONE=0300000001&RED_CUST_EMAIL=test@example.com&RED_EBT_PREVCUST=Y&RED_SHIP_FNAME=太郎&RED_SHIP_LNAME=山田&RED_SHIP_ADDR1=渋谷区&RED_SHIP_ADDR2=道玄坂1-14-6&RED_SHIP_ADDR3=ヒューマックス渋谷ビル&RED_SHIP_CITY=東京都&RED_SHIP_POSTAL_CD=1234567&RED_EBT_USER_DATA11=1&RED_EBT_USER_DATA12=2&RED_EBT_USER_DATA15=Y&RED_EBT_USER_DATA17=100&RED_EBT_USER_DATA18=1&RED_EBT_USER_DATA20=10&RED_OI_REPEAT=1&RED_ITEM_QTY1=1&RED_ITEM_PROD_CD1=123456789&RED_ITEM_MAN_PART_NO1=123456789&RED_ITEM_DESC1=食品&RED_EBT_ITEM_CST1=1000&RED_ITEM_GIFT_MSG1=コーヒー豆
ShopID=tshop11223344&ShopPass=PASSWORD&RED_AMT=1000&RED_CURR_CD=JPY&RED_CUST_FNAME=TAROU YAMADA&RED_CUST_ADDR1=渋谷区&RED_CUST_ADDR2=道玄坂1-14-6&RED_CUST_ADDR3=ヒューマックス渋谷ビル&RED_CUST_CITY=東京都&RED_CUST_POSTAL_CD=1500043&RED_CUST_CNTRY_CD=JP&RED_CUST_HOME_PHONE=0300000001&RED_CUST_EMAIL=test@example.com&RED_EBT_PREVCUST=Y&RED_SHIP_FNAME=太郎&RED_SHIP_LNAME=山田&RED_SHIP_ADDR1=渋谷区&RED_SHIP_ADDR2=道玄坂1-14-6&RED_SHIP_ADDR3=ヒューマックス渋谷ビル&RED_SHIP_CITY=東京都&RED_SHIP_POSTAL_CD=1234567&RED_EBT_USER_DATA11=1&RED_EBT_USER_DATA12=2&RED_EBT_USER_DATA15=Y&RED_EBT_USER_DATA17=100&RED_EBT_USER_DATA18=1&RED_EBT_USER_DATA20=10&RED_OI_REPEAT=1&RED_ITEM_QTY1=1&RED_ITEM_PROD_CD1=123456789&RED_ITEM_MAN_PART_NO1=123456789&RED_ITEM_DESC1=食品&RED_EBT_ITEM_CST1=1000&RED_ITEM_GIFT_MSG1=コーヒー豆&Token=wpd8A+R8uWZt+GnF6auJtMZNSB4yzSCZR9xdztqdBjGwBS7yYvxSiC0zeMVH+O4F
ShopID=tshop11223344&ShopPass=PASSWORD&RED_AMT=1000&RED_CURR_CD=JPY&RED_CUST_FNAME=TAROU YAMADA&RED_CUST_ADDR1=渋谷区&RED_CUST_ADDR2=道玄坂1-14-6&RED_CUST_ADDR3=ヒューマックス渋谷ビル&RED_CUST_CITY=東京都&RED_CUST_POSTAL_CD=1500043&RED_CUST_CNTRY_CD=JP&RED_CUST_HOME_PHONE=0300000001&RED_CUST_EMAIL=test@example.com&RED_EBT_PREVCUST=Y&RED_SHIP_FNAME=太郎&RED_SHIP_LNAME=山田&RED_SHIP_ADDR1=渋谷区&RED_SHIP_ADDR2=道玄坂1-14-6&RED_SHIP_ADDR3=ヒューマックス渋谷ビル&RED_SHIP_CITY=東京都&RED_SHIP_POSTAL_CD=1234567&RED_EBT_USER_DATA11=1&RED_EBT_USER_DATA12=2&RED_EBT_USER_DATA15=Y&RED_EBT_USER_DATA17=100&RED_EBT_USER_DATA18=1&RED_EBT_USER_DATA20=10&RED_OI_REPEAT=1&RED_ITEM_QTY1=1&RED_ITEM_PROD_CD1=123456789&RED_ITEM_MAN_PART_NO1=123456789&RED_ITEM_DESC1=食品&RED_EBT_ITEM_CST1=1000&RED_ITEM_GIFT_MSG1=コーヒー豆&MemberID=MEMBER0000001&SiteID=tsite11223344&SitePass=PASSWORD&SeqMode=0&CardSeq=0001
レスポンス
正常
RED_REQ_ID | 半角英数16桁
ReD Request IDReD Shield上でのトランザクションのユニークID |
|
---|---|---|
RED_ORD_ID | 半角英数16桁
Order/TransactionIDReD Shield上でのトランザクションの識別子 |
|
RED_STAT_CD | 半角英数記号11桁
Status Code 詳細な判定コード |
|
RED_FRAUD_STAT_CD | 半角英字9桁
ReD Shield Status Code ReD Shieldの判定結果 |
|
RED_FRAUD_RSP_CD | 半角英数記号4桁
Red Shield Response Code 予備項目です。 |
|
RED_FRAUD_RSP_MSG | 全半角512桁
Red Shield Response Message 予備項目です。 |
|
RED_FRAUD_REC_ID | 半角英数32桁
Red Shield Transaction ID ReD ShieldのトランザクションIDです。 |
RED_REQ_ID=350568945277&RED_ORD_ID=4E380852E56E7116&RED_STAT_CD=000.300.100&RED_FRAUD_STAT_CD=ACCEPT&RED_FRAUD_RSP_CD=&RED_FRAUD_RSP_MSG=&RED_FRAUD_REC_ID=000475120001RCH20221005125512745
ErrCode=E01&ErrInfo=E01040001